home *** CD-ROM | disk | FTP | other *** search
/ The X-Philes (2nd Revision) / The X-Philes Number 1 (1995).iso / xphiles / hp48hor2 / soundkit.doc < prev    next >
Text File  |  1995-03-31  |  3KB  |  79 lines
  1.                              SoundKit v1.1 
  2.  
  3.                            Fatri   -Feb 1993- 
  4.  
  5.                       Bytes : 1262  Checksum # 57A9h 
  6.  
  7.  
  8.    *************************************************************** 
  9.    * WARNING : Thought this library works fine on my HP48 Rev E. * 
  10.    * I cannot guarantee it would work on another ROM Rev.        * 
  11.    * Nor can I be taken for responsible for any kind of damage.  * 
  12.    * I however tested it seriously and didn't notice any bug     *    
  13.    ***************************************************************  
  14.  
  15. [Another warning!  This document is about the SOUNDKIT.LIB file, the 
  16.  SOUNDKIT.DIR file, and the SOUNDER file.  It is *NOT* about the 
  17.  SOUNDER.DIR file; see SOUNDER.DOC for details about that.  -jkh-] 
  18.  
  19. SoundKit is a library which purpose is to create sounds like 
  20. Joe Irvin's Sounder [called SOUNDER.DIR on this disk  -jkh-]. 
  21.  
  22. This package contains SoundKit v1.1, SOUNDER v1.1, and a directory 
  23. that shows you how to use SoundKit. I added the examples that were 
  24. suplied with Joe's PC Sounder-development system [not included here]. 
  25.  
  26. The instructions are the same as in Joe's Sounder: 
  27.  
  28. The arguments ( if any ) are real numbers, durations are in milliseconds. 
  29.  
  30. * sound : no arguments 
  31. Initialize the sound object. 
  32.  
  33. * pause : duration 
  34. Makes a pause of duration ms. 
  35.  
  36. * tone : frequency duration  
  37. Produces a beep.              
  38.  
  39. * noise : frequency duration 
  40. Produces a "white" sound. 
  41.  
  42. * sweep : frequency1 frequency2 duration 
  43. Produces a sweeping sound from frequency1 to frequency2 in duration ms. 
  44.  
  45. * sweepnoise : frequency1 frequency2 duration 
  46. Same as sweep but with "white" sound. 
  47.  
  48. * repeat : count 
  49. Begins a loop. 
  50.  
  51. * endrepeat : no arguments 
  52. Ends a loop. 
  53.  
  54. * endsound : no arguments 
  55. Ends the sound object and produces an executable program or only the 
  56. sound string ( depending on flag 1 ). 
  57.  
  58. To incorporate the sounds into your programs, store the executable prog 
  59. ( ".." SOUNDER ) under a name in your directory ( SOUNDER should be 
  60. there too ). 
  61.  
  62. You can also ( if flag 1 is set ) put the sound string right in a prog 
  63. and then call SOUNDER. 
  64.  
  65. However, as the sound string often contains null chr, you cannot use 
  66. the HP's editor to insert it in your prog.  This can be done using QED 
  67. or StrWrt.  [or use HACKIT to ->PRG it into a program.  -jkh-] 
  68.  
  69. Important note : The SoundKit instructions must be executed in a prog, 
  70.                  or at least from a command line. You cannot create a 
  71.                  sound right from the keyboard. 
  72.  
  73. Thanks to : 
  74.  
  75.  - Joe Ervin for SOUNDER and the PC-based sounder development system. 
  76.  - D. Muller and R. Hellstern for their useful SysRPL package. 
  77.  
  78. Fatri. (fatri@turing.u-strasbg.fr) 
  79.